home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / util / wb / RandomWBPatt.readme < prev    next >
Encoding:
Text File  |  2002-09-08  |  8.4 KB  |  162 lines

  1. Short:    Timer controled Slideshow-like random WBPattern change.
  2. Author:   RhoSigma, Roland Heyder (Germany) <http://rhosigma.gmxhome.de>
  3. Uploader: Roland Heyder <rhosigma@gmx.net>
  4. Version:  $VER: RandomWBPatt 4.231 (19.08.02)
  5. Type:     util/wb
  6. Requires: OS 3.0 (v39+), util/libs/ExtraLib.lha
  7.  
  8. english:
  9. ¯¯¯¯¯¯¯¯
  10. EMAILWARE - Please tell me what you think about this piece of Software ;-)
  11.  
  12. This small CLI-Program changes the file-entries within ENV:sys/WBPattern.prefs
  13. every given period of time. This automaticly forces IPrefs to refresh the WB
  14. to use the new pictures as background.
  15.  
  16. Installation: - Copy the program (RandomWBPatt) to C: (SYS:c)
  17.               - Create the files 'SYS:Prefs/Presets/PatternFiles-WB' and
  18.                 'SYS:Prefs/Presets/PatternFiles-WIN' which contain a listing
  19.                 of all Image-Files (incl. Paths) which you decide to use as
  20.                 patterns for either Workbench and/or Windows. In the very first
  21.                 line of that files you must place the number of files listed
  22.                 within the file. Take a look to the supplied sample file, if
  23.                 you are unsure. (see also History changes for v4.231)
  24.               - Note: You also need util/libs/ExtraLib.lha from Aminet
  25.  
  26. Usage: Use from CLI only !!
  27.  
  28.         RandomWBPatt ONCE/S WBONLY/S WINONLY/S TIMER/K PEN/K
  29.  
  30.        ONCE    - Set just one time new backgrounds and then quit immediatly
  31.        WBONLY  - Change only Workbench-Background
  32.        WINONLY - Change only Windows-Background
  33.        TIMER   - followed by a max. 4-digit number, which gives the period
  34.                  of time in minutes, after every time it is elapsed the new
  35.                  background is set
  36.        PEN     - followed by a max. 3-digit number in the range 0-255, which
  37.                  specifies the color used for outputs (see Notes)
  38.  
  39.        - If specified both, ONCE and TIMER, ONCE has higher priority !!
  40.        - If specified both, WBONLY and WINONLY, WBONLY has higher priority !!
  41.        - If specified no ONLY-Option, then both backgrounds are affected.
  42.        - If no Option is given, the defaults used are TIMER=30 PEN=3
  43.        - If you don't use ONCE, use 'Run >NIL: RandomWBPatt Options' i.e. if
  44.          you start the program within S:User-Startup.
  45.  
  46.        - you may quit the program using the CLI-Command 'Break' by sending
  47.          a CTRL-C to it, the program then quits within the next minute
  48.        - you also can send a CTRL-F, which forces RandomWBPatt to break its
  49.          time cycle and load a new background immediatly (well, within the
  50.          next minute)
  51.  
  52. Notes: The program creates another two files called 'PatternFiles-WB.done' and
  53.        'PatternFiles-WIN.done' which list all Image-Files which were already
  54.        shown. The random engine uses these files to avoid Image-Repeats until
  55.        every image is shown at least one time.
  56.         The PEN-Option is only useful if you are using a 800x600 WB-Screen and
  57.        if you also have installed and started StopMenu. In this case you must
  58.        also copy the three .info-Files to STOPMENU:icons/program and then let
  59.        yourself surprise what happens after RandomWBPatt is started.
  60.  
  61. See also my other Software on Aminet:
  62.              util/libs/ExtraLib.lha
  63.              dev/basic/MBPrefs.lha
  64.  
  65. deutsch:
  66. ¯¯¯¯¯¯¯¯
  67. EMAILWARE - Bitte teilt mir eure Meinung über dieses Programm mit ;-)
  68.  
  69. Dieses kleine CLI-Programm schreibt jeweils nach einer angegeben Zeitperiode
  70. neue Bilddateinamen in die Datei ENV:sys/WBPattern.prefs, was IPrefs auto-
  71. matisch dazu bringt, diese als neue Hintergründe anzuzeigen. Die Bilder werden
  72. zufällig aus einer vorgegebenen Liste von Dateinamen ausgewählt.
  73.  
  74. Installation: - Kopieren Sie die Programmdatei (RandomWBPatt) nach C: (SYS:c)
  75.               - Legen Sie die Datein 'SYS:Prefs/Presets/PatternFiles-WB' und
  76.                 'SYS:Prefs/Presets/PatternFiles-WIN' an, die alle Bilddateien
  77.                 (incl. Pfad) auflisten, welche Sie als Hintergrund für die
  78.                 Workbench bzw. Windows verwenden wollen. In der ersten Zeile
  79.                 der Dateien muß jeweils die Anzahl der in der Datei gelisteten
  80.                 Bilder stehen. Sehen Sie sich die mitgelieferte Datei an, falls
  81.                 Sie sich unsicher sind. (siehe History Veränderungen ab v4.231)
  82.               - Achtung: Sie brauchen util/libs/ExtraLib.lha aus dem Aminet
  83.  
  84. Benutzung: Nur vom CLI aus !!
  85.  
  86.             RandomWBPatt ONCE/S WBONLY/S WINONLY/S TIMER/K PEN/K
  87.  
  88.            ONCE    - Setze einmal neue Hintergründe und beende dann sofort
  89.            WBONLY  - Setze jeweils nur neuen Workbench-Hintergrund
  90.            WINONLY - Setze jeweils nur neuen Windows-Hintergrung
  91.            TIMER   - gefolgt von einer max. 4-stelligen Zahl, die die Periode
  92.                      in Minuten angibt, nach der jeweils ein neuer Hintergrund
  93.                      gesetzt werden soll
  94.            PEN     - gefolgt von einer max. 3-stelligen Zahl zwischen 0-255,
  95.                      die die zu verwendende Schriftfarbe angibt (s.Bemerkung)
  96.  
  97.            - Sind ONCE und TIMER angegeben, dann hat ONCE Priorität !!
  98.            - Sind WBONLY und WINONLY angegeben, dann hat WBONLY Priorität !!
  99.            - Ist keine ONLY-Option angegeben, werden beide Hintergründe gesetzt.
  100.            - Wird gar keine Option angegeben, gilt TIMER=30 PEN=3
  101.            - Wird kein ONCE verwendet, dann sollten Sie das Programm mittels
  102.              'Run >NIL: RandomWBPatt Optionen' asyncron starten, z.B. wenn Sie
  103.              es von der S:User-Startup aus starten wollen.
  104.  
  105.            - Sie können das Programm beenden, indem Sie mit dem CLI-Befehl
  106.              'Break' ein CTRL-C Signal an dieses senden, das Programm beendet
  107.              dann innerhalb einer Minute.
  108.            - Sie können auch ein CTRL-F senden, was RandomWBPatt dazu bringt,
  109.              den aktuellen Time-Zyklus zu beenden und sofort einen neuen
  110.              Hintergrund zu laden (o.k. ja, kann auch bis zu einer Minute dauern)
  111.  
  112. Bemerkung: Das Programm legt selbst noch die zwei Dateien 'PatternFiles-WB.done'
  113.            und 'PatternFiles-WIN.done' an, in der alle bereits einmal angezeigten
  114.            Bilder vermerkt werden. Der Zufallsgenerator benutzt diese Datein, um
  115.            Bild-Wiederholungen zu vermeiden, bis alle Bilder mindestens einmal
  116.            angezeigt wurden sind.
  117.             Der PEN-Parameter ist für Sie nur von Interesse, wenn Sie erstens
  118.            einen 800x600 Pixel großen WB-Bildschirm verwenden, und zweitens
  119.            StopMenu installiert ist und auch gestartet ist. Kopieren Sie in
  120.            diesem Fall noch die drei .info-Dateien nach STOPMENU:icons/program
  121.            und lassen sich überraschen, was nach Start von RandomWBPatt passiert.
  122.  
  123. Werfen Sie doch auch mal einen Blick auf meine andere Software im Aminet:
  124.          util/libs/ExtraLib.lha
  125.          dev/basic/MBPrefs.lha
  126.  
  127. -----------------------------------------------------------------------------
  128.  
  129. History:
  130. ¯¯¯¯¯¯¯¯
  131. v3.089 (30.03.02)
  132.        - First public release
  133.  
  134. v3.222 (10.08.02)
  135.        - Random generator reworked: As more pictures from the given list were
  136.          already shown, as longer it takes for the random generator to get a
  137.          hit on an still unshown picture, finally ending up in an endless loop
  138.          causing heavy disk activity.
  139.           Now after a maximum of 100 random tries, the generator is switched to
  140.          sequencial mode to find the few remaining unshown pictures.
  141.  
  142.        - Got one mail until today, somebody was asking for a GUI/FileRequester
  143.          to create the 'SYS:Prefs/Presets/PatternFiles' list-file. Is it really
  144.          needed ??
  145.  
  146.        - I simply use the Shell-CMD 'List <PATH> [ALL] FILES LFORMAT %F%N' to
  147.          create the listing. Using redirection '>' to a file or append re-
  148.          direction '>>' to add the listing to an already existing list-file.
  149.          After that load the file into an editor tool with line counting ability
  150.          (most of modern editors can do this) adding the line count at the head
  151.          of that list and save it again. Altogether it takes me less than one
  152.          minute to create a listing of a complete directory. So why a GUI ??
  153.  
  154. v4.231 (19.08.02)
  155.        - Major change for this Version is the splitting of the old list file
  156.          'SYS:Prefs/Presets/PatternFiles' to the files 'PatternFiles-WB' and
  157.          'PatternFiles-WIN' which hold the Image-Listings for the corresponding
  158.          WBPattern-Settings 'Workbench' and 'Windows'
  159.  
  160.        - Minor changes: some more enhancements on random generator code and
  161.                         CTRL-C/F handling.
  162.